home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / clang / mcomm540.zip / MUSTREAD.DOC < prev    next >
Text File  |  1991-01-10  |  6KB  |  110 lines
  1.  
  2.  
  3.                             MCOMM ASYNC LIBRARY NOTES
  4.  
  5.             This file contains information on configuring the libraries
  6.          for use with your compiler and some Zortech C compiler specific
  7.          notes.  If your application may be ran on a system that uses a
  8.          Western Digital 16550, be sure and read the notes on this chip
  9.          in ASYNC.DOC.  The file, UPDATE.DOC, contains important
  10.          information regarding changes or additions to the library and
  11.          header files.  Be sure and read this file also.  The area code
  12.          for east Texas has been changed from 214 to 903 effective
  13.          November 1, 1990.  After May 1, 1991, the old area code will no
  14.          longer work.  The new numbers are:
  15.  
  16.             Split Up the Middle BBS       (903) 838-6713
  17.             Mike Dumdei (voice)           (903) 838-8307
  18.  
  19.  
  20.                        LIBRARY AND HEADER FILE INFORMATION
  21.  
  22.          The composite LIBs listed below contain all the functions des-
  23.          cribed in ASYNC.DOC and SUPLMNT.DOC.  As supplied on the disk
  24.          the LIBs are setup for linking using Microsoft C or Quick C.
  25.          If you use Turbo C you need to run the batch file, TCLIBS.BAT,
  26.          to convert the LIBs to Turbo C format.  If you use Zortech C,
  27.          you will need to run ZTCLIBS.BAT.
  28.  
  29.          The conversion is necessary because a few of the non-async
  30.          functions are written in C and call library functions that have
  31.          different names in Microsoft C, Turbo C, and Zortech C.  All
  32.          the C code used is included in the shareware version so that if
  33.          you are using a compiler, other than one of the above, that
  34.          does use Microsoft calling sequences, you can recompile the
  35.          code, update the composite LIBs, and still use the library.
  36.  
  37.          In addition, the following statements are contained in COMM.H,
  38.          ANSIDRV.H, and EXTRA.H:
  39.  
  40.                          #if !defined(MCOMM)
  41.                            #define _C_ cdecl
  42.                            #define _N_ near
  43.                            #define _F_ far
  44.                            #define MCOMM
  45.                          #endif
  46.  
  47.          These definitions are not totally up to date with MSC 6.0 and
  48.          QC 2.5 (they have added a leading underscore for ANSI compat-
  49.          ibility), however, they do still work with these compilers and
  50.          they also work with Turbo C 2.0, Zortech C, and previous
  51.          versions of Microsoft's compilers. If you are using a different
  52.          compiler, you may need to change the 'cdecl', 'near', and 'far'
  53.          keywords to the equivalent names used by your compiler.
  54.  
  55.  
  56.  
  57.  
  58.          Only the small model version of the LIBs is included in the
  59.          shareware version.
  60.  
  61.          COMPOSITE LIBS:
  62.             COMM_S.LIB     ;small model LIB of all routines
  63.             COMM_C.LIB     ;compact model LIB of all routines
  64.             COMM_M.LIB     ;medium model LIB of all routines
  65.             COMM_L.LIB     ;large model LIB of all routines
  66.             COMM_H.LIB     ;created by TCLIBS.BAT (only used by TC)
  67.  
  68.          CONVERSION LIBS: (used by TCLIBS.BAT, MSCLIBS.BAT, ZTCLIBS.BAT)
  69.             TC_XS.LIB      ;used to convert COMM_S to TC
  70.             TC_XC.LIB      ;used to convert COMM_C to TC
  71.             TC_XM.LIB      ;used to convert COMM_M to TC
  72.             TC_XL.LIB      ;used to convert COMM_L to TC
  73.             TC_XH.LIB      ;used to convert COMM_L to TC COMM_H
  74.             MSC_XS.LIB     ;used to convert COMM_S to MSC
  75.             MSC_XC.LIB     ;used to convert COMM_C to MSC
  76.             MSC_XM.LIB     ;used to convert COMM_M to MSC
  77.             MSC_XL.LIB     ;used to convert COMM_L to MSC
  78.             ZTC_XS.LIB     ;used to convert COMM_S to ZTC
  79.             ZTC_XC.LIB     ;used to convert COMM_C to ZTC
  80.             ZTC_XM.LIB     ;used to convert COMM_M to ZTC
  81.             ZTC_XL.LIB     ;used to convert COMM_L to ZTC
  82.  
  83.  
  84.          Zortech C Specific Information:
  85.  
  86.             The Zortech C IO.H file and MCOMM COMM.H file have a name
  87.             clash with the defined variable 'R_OK'.  Zortech has it
  88.             defined as 4 and MCOMM defines it as 0.  The MCOMM
  89.             documentation makes references to a return value of R_OK so
  90.             rather than define it out in COMM.H, I left it in.  I
  91.             thought it was better for you to get a compiler error that
  92.             you could find than defining out R_OK if __ZTC__ was defined
  93.             and you not knowing what was wrong when a function that was
  94.             supposed to return R_OK didn't (since R_OK was 4 instead of
  95.             0).  The solution is to define it out of COMM.H if __ZTC__
  96.             is defined and then everywhere an MCOMM function is supposed
  97.             to return R_OK, look for a return value of 0.
  98.  
  99.             Control-break locks up the SMALTERM demo programs.  I think
  100.             the problem is:  Zortech C control-break causes you to exit
  101.             to DOS where MSC and TC do not as long as only the BIOS key
  102.             functions are used.  When SMALTERM exits to DOS with the
  103.             interrupts still hooked, the demo crashes. This only applies
  104.             to Zortech C/C++.  I tried using the signal functions to fix
  105.             it but didn't get it.  If you are an experienced Zortech
  106.             user and want to tell me how to make Zortech C run the exit
  107.             term function when control-break is pressed before it exits
  108.             to DOS, I will correct it for the next version.
  109.  
  110.